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OVERVIEW 


Integer Basic Plus was developed to fill a need for those people who bought 
an Apple t! Plus without the Integer Firmware Card. The concept of a RAM 
version of Integer Basic was first implemented by James McBride when he 
successfully relocated it on a friends Apple Il + with 32K RAM. It worked 
great, with the exception that all programs had to be SAVEd to or LOADed 
from cassette tape. $ 


A friend of McBrides, Garth Hitchens, was asked to work out the required 
DOS modifications to enable programs to be LOADed and SAVEd on disk. 
The next step was to cause the RAM Integer to emulate the protocols of 
RAM Applesoft, and this was soon accomplished. 


At this point RAM Integer Basic could do almost anything the ROM ver: 
sion could do except for certain programs which CALL on routines in the 
Integer ROM which are not actually a part of the Integer Basic tanguage, and, 
in addition, the RAM version was not relocatable. After more effort, a relo 
catable version was developed. followed shortly by a self-relocating version. 
retocating version. 
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RAM Integer Basic nad become a reality. Now, in discussion with ie 
ectors of APPLE. in connection with making this available to the m 
ship, it was decided to enhance the language beyond its ongina! power Furst 
the unused ANDX token was modified to USER and 50 functions suc 
CHRS, FLASH and Output Hex were predefined, with another 6 furw: 
available for definition by the user. And thena DOS ONERR GOTO rain 
was added in to complete the package. 









McBride and Hitchens are both in their mid-teens and have more the? | 


proven their capabilities as programmers. Their combined teamwork has tè 
sulted in the production of another praduct that may be enjoyed by ali 
A.P.P.L.E. members. 


GETTING STARTED WITH THE INTEGER BASIC + SYSTEM 


Tne Integer Basic Plus System has been designed for ease of use. Wherever 
possible it duplicates exactly the functions of the standard ROM based Inte- 
ger Basic. It is compatible with the Program Line Editor :f PLE is first 
RUN from Applesoft before entering Integer. 


H this is your first experience with Integer Basic, you should buy and study 
the Integer Basic Programming Manual, published by Apple Computer, Inc. 
and available from your locat dealer, 


To start the system up. just insert the Integer Basic Ptus System master aisk- 
ette in your disk drive and follow your normal booting procedure, which $ 
described in the DOS 3.2 manual. For a regular Apple Itt, it is a matter of 
turning the power off, inserting the diskette and turning the power back on, 
which will result in an autoboot. 


After the disk has booted, you will be greeted first by the “Hello” program -r 


and the Applesoft prompt ( } ). This is the time to RUN Program Line Editor 
if you care to. 

Also at this time, if you already have Integer Basic in ROM, either on the 
main board of an Apple tl or on a firmware card on an Apple WW +, and you 
wish to use Integer Basic Plus rather than the AOM version, enter BRUN 
ROM INTEGER. This will confuse DOS to the extent that it will not know 
you have Integer ROM on board and will allow you to use the RAM version 
instead. 

To Enter Integer Basic Plus, just type “INT” followed by a carriage return 
and integer Plus will load, and give you the standard Integer Basic prompt 
{>), indicating that you now may proceed to LOAD and SAVE programs in 
the normal manner and use Integer as needed. 

CAUTION: You may use the FP command to return to Applesoft, but any 
attempt to LOAD or RUN an Integer program trom Applesoft without 
first entering an INT will not be successful. Thismay be modified in a tater 
version 








mM 


% 


TRANSFERRING INTEGER TO OTHER DISKETTES 


The DOS contained on your Integer Basic Plus System master diskette >» 2 
unique, highly modified 3.2.1 DOS. It 1s recommenied that you ites 
ately make a back up Cupy of the System master in the event of its su 
quent failure. A copy may be made using the Apple copy program 
Single/Dual Drive Copy program from our diskpak 6, In each case, just fonce 
your usual Copy procedures. ` S tey 

In some cases, it may be desirable to transfer the Integer program 7o 
another previously initialized diskette. !f this is done, itas imperative that T2 
“Update 3.2.1” program included on your Integer Basic Plus System maste 
diskette be used. To do this, type the following commands from Appiesott 
mode: 





] LOAD INTEGER (on Integer master diskette} 
] SAVE INTEGER ton new diskette) 
} BRUN UPDATE 2.2.14 (on Integer master diskette) 


When the Update 3.2.1 program BRUNs, you will be prompted what to do 
Just type the file name of the helio program you have assigned to the new 
diskette when requested. After the new diskette has been updated, you May 
use it just as you previcusly used the master. 


Note that ONLY the Update 32? program from the Integer Basic Pius 
System master diskette may be used The same program from the Appie 
master diskette will NOT work because the Apple diskette has only standard 
3.2.1. DOS. : 


USER (x) FUNCTIONS 


USER (x) functions are a method of expanding standard Integer Basic wth 
additional commands. There are 20 pre-defined USERIx) commands and a^ 


additional 6 may be defined by the user. The USER(x) commands may be o 


entered into a program in one of two ways: 


1, 100 PRINT USERIx), (where xrepresents a number 
from 0 to 25.) 
{where x represents a number 


from 0 to 25.) 


Method 1 is preferable because it is processed more rapidly than method 2. 
The USER(x) function may be incorporated into a PRINT statement, using 
semicolons, etc., just as you would any standard PRINT function. An exam- 
ple of printing the word “HELLO” to the screen in INVERSE video would be 
as follows: 


110 PRINT USER(1); “HELLO”. USER(2) : END 


This would change the output mode to INVERSE, print “HELLO” and then 
restore the output mode to NORMAL. Note that the PRINT command need 
be used only once. 


2. 100 N = USERIx) 
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USER(x) functions 16 und 17, which return a HE XS or CHAS eespectively 
may be used as 41 the following example 


120 POKE 1,255. PRINT USERi16). END 


This would return “FF” to your display A more detiet explinsuont uppers 
in the following hst of USER(x) commands dad ther application, |. 


TABLE OF USER (x) FUNCTIONS 


0 


enon 


10. 


Ve 


12. 


14, 


15. 


43. 


CLEAR TEXT SCREEN. This will clear the text screen to the current 
output mode. If the current mode is INVERSE, then PRINT USERIO! 
would return an aii white screen area. 


_ INVERSE. Sets the INVERSE mode: aff text output to the screen wilt 


now appear as black characters on white. 


. NORMAL. Returns the video display to the NORMAL (white on black) 


mode. 


. FLASH. Sets character output to alternate between NORMAL and IN 


VERSE. (See 1 and 2, abovel. 


. CURSOR UP. Moves the cursor up one space Enter the following tine to 


test this function: 130 CALL 936: VTABI6: TAB2: PRINT “HEL: 
LO”; USER(4); USER(4);: ENO This function supplements VTAB 


. CURSOR DOWN. Moves cursor down one space. Functions as 4, above. 

. CURSOR LEFT. Moves cursor one space to the left 

. CURSOR RIGHT. Moves cursor one space to the night. 

| FAST MIXED GR CLEAR. Clears the screen to Mined graphies mode 


(four lines of text on the bottom) to the color previously set with the 
COLOR = command. 


. FAST FULL GR CLEAR. Clears the screen to full graphics mode (no text 


panel) to the color previously set with the COLOR = command. 

CLEAR TO EOP. Clears the text screen from the present cursor postion 
to the end of the page. 

CLEAR TO EOL. Clears the text screen from the present cursor position 
to the end of the current line. 

SCROLL UP, Scrolls the text screen up one tine, filling in at the bottom 
with a blank line of text. If the wdeo mode were set to INVERSE, 
the fill line would appear as white. If the video mode was set to NOR- 
MAL, there would be no apparent difference. Experimentation with the 
four SCROLL commands, USER(12) to USER(15) inclusive, will 
show you how to use these functions to draw INVERSE or FLASH- 
ing borders, etc., on your text screen, 


SCROLL DOWN. Functions exactly as 12. above, except scrolls down 
with top fill. 

SCROLL LEFT. Functions exactly as 12, above, except scrolls teft with 
fill on the right. 

SCROLL RIGHT. Functions exactly as 12, above, except scrolls right with 
fill on the left. 
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16. HEX$. Returns a hexadecimal value equivatent to the decimal value pre 
viously POKEd into location 1, an the range O to 255. Example: 


POKE 1,128: PRINT USEA(16) would return a hex value of 80. 


17. CHRS.. Returns to the screen the ASCII character whose value has prew: 
ously been POKEd into 1, Example. POKE 1,223. PRINT USER?! 
would print an underscore “—” to the screen or, POKE 1,225: PRINT 


USER(17) would print tower case “a to the scréen if you have the Dan 
Paymar chip and can display lower case. (Else ıt would print a a tae 
Note that unlike Applesoft, the Integer Basic ASCII character set of 
NORMAL characters is in the range 128 to 255. POKEing 1 with a 
value fess than 128 will result in outputting either FLASH or INVERSE 
characters. 

18. BASIC ADDRESS. Stores the high byte of the beginning of Integer Basc 
Plus in location $00. This is used internally by Integer Basic Plus, Dut 
may prove helptul in patching in routines that call on the Integer ROM. 

19. DOS ONERR GOTO. This routine, based on one written by Andy Hertz- 
feld, is a DOS error handling routine that functions in a manner similar 
to the Applesoft ONERR GOTO. tts purpose is to prevent a disk-based 
program from aborting when an error is encountered, by instructing the 
program to jump to a specified line number. 


it is enabled by entering a PRINT USER(19)", POKEing the error 
handling line number, MOD256 into 10, and POKEing the error hand- 
ling line number /256 into location 11. When an error occurs, the error 
type will be found by PEEKing at 7 and the tine number of the line 
that caused the error will be returned in tocations 8 and 9. Standard 
DOS error codes, as shown on Pages 114-115 of the DOS 3 2 manual 
are used. The following «s a short program to demonstrate the use of 
DOS ONERR GOTO 


10 REM DOS ONERR GOTO DEMO 
20 PRINT USER(19); 
30 POKE 10, 1000 MOD 256: POKE 11, 1000/256 
40 «DS =": REM CTRL D IN QUOTES 
50 PRINT DS; “CATALOG” 
60 GOTO 50 
70 REM OPEN DRIVE DOOR TO GENERATE 
A DISK 1/0 ERROR 


1000 REM ERROR HANDLING ROUTINE 

1010 PRINT “ERROR TYPE : “PEEK” ”; 

1020 PRINT “AT LINE : ”; PEEK(8) + PEEK {9} * 256 
1030 REM CLOSE YOUR DRIVE DOOR 

1040 PRINT: GOTO 50 


NOTE: Use of the DOS ONERR GOTO routine does not inhibit the printing 
of DOS error messages, which can be a DANGEROUS practice that in direct 
mode could conceivably lead to damage of your diskette or program, how- 
ever, for those that care to, the following two program lines will disable and 
re-enable the DOS error message. Both lines must be used within the pro- 


gram, with 32767 just preceding or a part of the END statement. 
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32766 ERRMSG=256-( PEEK (978 1-256 
è i PEER i978 }>127) )+2524: POKE 
ERRMSG.18: REM DISABLE ERRMSG 


7 32767 POKE ERAMSG,4: END : REM RE-ENA © 
BLE ERRMSG 


20 to 25 inc. Are undefined ana may be utilized by users for their own pur 
poses. See the following sect-on to define your own functions. 


DEFINING YOUR OWN FUNCTIONS 


In addition to USER(O) through USER(19) which are predetined. you may 
set up your own functions with USER(20) through USER(25) The user de 
fined functions will allow you 76 eater jumps to any memory location, an 
dexed by its address in the varable RTN. For the sake of Consistency usr 


defined functions should be de#:-2d within the program that utihees thom A. 


text file, “USER DEFINE” has >29 established for this purpose 


Lf you wish to add a function to an existing program. just LOAD the peo 
gram and EXEC USER DEFINE. set the variable FUN to equal the number to 
be assigned to the function and set RTN to equal the address of the routine 
to be called by the function. In tne following program example, RTN = -936. 
Asa last step, enter a line in your program to GOSUB 32760. 


> EXEC USER DEFINE 

10 REM PROGRAM TO DEFINE AND DEMO 
USER(20) 

20 FUN = 20: RTN = -936 

30 REM VARIABLES ARE NOW SET UP 

40 GOSUB 32760: REM DEFINE THE FUNCTION 

50 REM USER(20) NOW DOES A CALL -936 

60 REM NOW LETS TRY IT 


100 PRINT USER(20), “THE SCREEN IS 
NOW CLEARED”: END 
32760 - 32765 (User define routine? 


In addition to defining the unused USER (x) functions, you may abo rede 
fine any of the eatstiny Ones to Sut your OWN needs, e g. USER(S) coukt be 
redefined to clear the wreen, ever though it was onginally defined to ser the 
FLASH mode Note ‘nat these changes will not be present when the system 
is rebooted, but they eal! be carried from program to program 
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STOP LIST FEATURE 


Integer Basic Plus also includes a stop list feature. To temporarily halt a pro 
gram listing, enter a CTRL S. Any other key will resume the listing. A CTRL 
C will abort the listing altogether and return control to integer Basic. 


PROGRAM COMPATIBILITY 


Integer Basic Plus to standard Integer Basic 
Programs written in Integer Basic Plus will run on a standard Apple tI 
provided that the USERIx) function is not used and provided that 
there are no CALLS to special Integer Basic Plus tocations. 


Integer Basic Plus to Integer Basic Plus 
Programs written in Integer Basic Plus utilizing CALLs to special Inte 
ger Basic Plus locations will run only on a system with the same mem: 
ory size as yours. Programs written using only the USER (x) function 
will run on any Integer Basic Plus system. 


Standard Integer Basic to Integer Basic Plus 
Any standard Integer Basic program should run under Inieger Basic 
Plus with the exceptions of programs that reference addresses in the 
Integer ROM. However, these programs may be modified easily so that 
they will run property. A program named “CONVERT” has been in- 
Integer ROM addresses in any binary program, and some Integer pro- 
grams where the address 15 in Hex. 


To use this feature, boot the Integer Basic Plus System master diskette 
and RUN Convert. Place the diskette with the program to be conver- 
ted in the disk drive and respond with the name ot the program to be 
converted when prompted to do so. The process is automatic, and the 
converted program will be SAVEd to disk with the name of the original-... 
program followed by the suffix “CON”. 


Convert will convert most Assembly Language programs but will convert only 
those Integer Basic programs in which the ROM address is given in hexadeci- 
mal, as in a program using Lam's Monitor String Routine. 


Users are cautioned again that any programs utilizing either special addresses 
i or the USER(x) function will NOT run on standard Integer Basic. Therefore 
i these features should not be used in programs for commercial use or for 
: others wha do not have Integer Basic Plus available. 








QUICK REFERENCE LIST - TED H+ 


COMMANDS AND PSEUDO-OPS . 
Executive Mode Edit Mode Sub-Commands 
. # SET DAIVE # Carnage rin 
c CATALOG arCeiM Accept entire tine 
D DISK COMMAND Cr! Q Accept to cursor 
M MONITOR COMMAND Cri F Find character 
L LOAD SOURCE FILE Cif Insert character. i 
S SAVE SOURCE FILE ClO Insert ctrl char 
o OBJECT CODE SAVE Cri D Detete character | 
A APPEND FILES Cui R Restart Edit i 
T TED (ENTER EO/ASM) Cri C Exit edit mode 
oS , a ou TED System Pseudo ops i 
= i OBJ Set OB aduress ! 
o a See Commands ORG Set ORG adaress 
. A 
e TE : NEW Clear existing suusce fite eou ssign address to labet 


LOmem: Set lower limit of source 
Hine: > Set hyn limit of source 


AST Print asterisks ba 
LSTON Turron hsting ' 
LST OFF Turn off usung i 


PRE Same us BASIC PR# PAG Clear screen 
LEN Display source length PRE Output to PR 
LOAD Load cassette source SYM Print symbol table 
SAVE Save cassette source END Ena of program 
TABS Set or clear tab stops i 
; . List - List Imes as specified Optional 6502 instructions 
eh ce Find Find hne # or string BLT Same as BCC 
=| ASM `~ Assemble source file BGE Same as BCS 
5 : Quit Quit TED and enter EXEC 
Entry Commands Functional Pseuoo ops 
Adi Add tines mode ASC Enter ASCH code 
: Insert Insert ines mode DCI Same except last ovte 
Dclere Delete lines mode HEX Enter hex data 
; : copy Copy one range to another ow Enter one byte of hex 
nee? Change Change string to another DS Geserve Dytes 
Edit Edit line #, range or string DA Wete iabel address 


DB Write label adr low H l 
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